Release 10.1A: OpenEdge Development:
Progress Dynamics Administration

Entity translations

Translations in the previous sections apply primarily to field labels associated with specified visual objects at run time (widget translations), such as browser columns and widget objects on viewers. You can also specify translations (entity translations) at the entity object (DataField) level of an entity, no matter what visual object displays them.

Dynamics makes entity translations available to dynamic browser (DynBrow) and dynamic viewer (DynView) objects that are linked to dynamic Progress SmartDataObjects™ (DynSDO), and also to DynView objects linked to a static SDO. Entity translations also apply to the field labels displayed in the standard Progress Dynamics Lookup or Filter browser. If DataField objects with entity translations are used by visual objects that have widget translations, the widget translations override any entity translations when the fields are displayed using these visual objects.

Note: Automatic resizing and positioning of widgets to accommodate translated labels does not occur when using entity translations. When using entity translations, you must provide enough layout space to display the translated labels to avoid overlapping fields.

You can specify entity translations using these tools:

Translation Maintenance tool.
Migrate Widget Translation tool.

Using Translation Maintenance

The Translation Maintenance window allows you to manually specify entity translations for individual fields similar to widget translations. (See the "Translation Maintenance window" section.) Specify the field values in this window as you do for widget translations, except for the following fields:

Object name — The name of the entity where the translated field resides.
Note: Be careful not to select a field name in the lookup. Select only the name of an entity. You can eliminate field names from the selection by using the lookup filter with the Object type code From and To values set to Entity, along with other filter settings, such as appropriate Object filename values.
Widget type — DataField.
Note: The value, Global translation, specifies a single widget translation that applies to all visual objects that display values for the specified field.
Widget entry — 1 specifies to translate the field label; 2 specifies to translate the field column label.
Original tooltip — Not used (blank).
Translation tooltip — Not used (blank).

Using Migrate Widget Translation

The Migrate Widget Translation tool allows you to automatically convert existing widget translations to entity translations for specified entities in specified databases. You also have the option to remove any existing widget translations and to skip entity translation for any fields that have multiple widget translations.

The Migrate Widget Translation tool is separate from the AppBuilder tools. To use this tool, run the afmigtrnww container with the Dynamic Launcher (Compile Dynamic Launcher from the AppBuilder window).